| Server IP : 121.121.20.254 / Your IP : 216.73.216.202 Web Server : Microsoft-IIS/10.0 System : Windows NT WEB-SERVER 10.0 build 20348 (Windows Server 2022) AMD64 User : IUSR ( 0) PHP Version : 8.3.28 Disable Function : NONE MySQL : ON | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/Program Files/LibreOffice/help/en-US/text/sbasic/shared/ |
Upload File : |
<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<base href="../../../../">
<noscript><meta http-equiv="refresh" content="0; URL=../../../../en-US/noscript.html"></noscript>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>FormatDateTime Function [VBA]</title>
<link rel="shortcut icon" href="media/navigation/favicon.ico">
<link type="text/css" href="normalize.css" rel="Stylesheet">
<link type="text/css" href="prism.css" rel="Stylesheet">
<link type="text/css" href="default.css" rel="Stylesheet">
<script type="text/javascript" src="polyfills.js"></script><script type="text/javascript" src="languages.js"></script><script type="text/javascript" src="en-US/langnames.js"></script><script type="text/javascript" src="flexsearch.debug.js"></script><script type="text/javascript" src="prism.js"></script><script type="text/javascript" src="help2.js" defer></script><script type="text/javascript" src="a11y-toggle.js" defer></script><script type="text/javascript" src="paginathing.js" defer></script><script type="text/javascript" src="en-US/bookmarks.js" defer></script><script type="text/javascript" src="en-US/contents.js" defer></script><script type="text/javascript" src="help.js" defer></script><meta name="viewport" content="width=device-width,initial-scale=1">
</head>
<body>
<header id="TopLeftHeader"><a class="symbol" href="en-US/text/shared/05/new_help.html"><div></div></a><a class="logo" href="en-US/text/shared/05/new_help.html"><p dir="auto">LibreOffice 24.2 Help</p></a><div class="dropdowns"><div class="modules">
<button type="button" data-a11y-toggle="modules-nav" id="modules" aria-haspopup="true" aria-expanded="false" aria-controls="modules-nav">Module</button><nav id="modules-nav" hidden=""></nav>
</div></div></header><aside class="leftside"><input id="accordion-1" name="accordion-menu" type="checkbox"><label for="accordion-1" dir="auto">Contents</label><div id="Contents" class="contents-treeview"></div></aside><div id="SearchFrame"><div id="Bookmarks">
<input id="search-bar" type="search" class="search" placeholder="Search in bookmarks for chosen module" dir="auto"><div class="nav-container" tabindex="0"><nav class="index" dir="auto"></nav></div>
</div></div>
<div id="DisplayArea" itemprop="softwareHelp" itemscope="true" itemtype="http://schema.org/SoftwareApplication">
<a name="FormatDateTime"></a>
<a name="bm_id3150499"></a>
<meta itemprop="keywords" content="FormatDateTime function">
<h1 id="hd_id3150499" dir="auto">FormatDateTime Function [VBA]</h1>
<p id="par_id3151384" class="paragraph" dir="auto">Applies a date and/or time format to a date expression and returns the result as a string.</p>
<div class="embedded">
<a name="vbasupport"></a>
<div class="warning">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/warning.svg" alt="warning" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id051920171018124524" dir="auto">This constant, function or object is enabled with the statement <a target="_top" href="en-US/text/sbasic/shared/03103350.html"><span class="literal">Option VBASupport 1</span></a> placed before the executable program code in a module.</p></div>
</div>
<br>
</div>
<div class="embedded">
<a name="functsyntax"></a>
<h3 id="hd_id061420171139089682" dir="auto">Syntax:</h3>
</div>
<div class="bascode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Click on text to copy to clipboard"><pre dir="auto"><code class="language-visual-basic line-numbers">
FormatDateTime (Date As Date [, NamedFormat As Integer])
</code></pre></div>
<div class="embedded">
<a name="functvalue"></a>
<h3 id="hd_id061420171139087480" dir="auto">Return value:</h3>
</div>
<p id="par_id3150669" class="paragraph" dir="auto">String</p>
<div class="embedded">
<a name="functparameters"></a>
<h3 id="hd_id061420171139084157" dir="auto">Parameters:</h3>
</div>
<p id="par_id240720170117391741" class="paragraph" dir="auto"><span class="emph">Date</span>: The date expression to be formatted.</p>
<p id="par_id24072017011739895" class="paragraph" dir="auto"><span class="emph">NamedFormat</span>: An optional <span class="emph">vbDateTimeFormat</span> enumeration specifying the format that is to be applied to the date and time expression. If omitted, the value <span class="emph">vbGeneralDate</span> is used.</p>
<h3 id="hd_id811512136434300" dir="auto">Date and Time formats (vbDateTimeFormat enumeration)</h3>
<a name="FormatDateTime_constants"></a>
<table border="1" class="" cellpadding="0" cellspacing="0">
<tr>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id201512137337536" class="tableheadintable" dir="auto">Named Constant</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id481512137342798" class="tableheadintable" dir="auto">Value</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id781512137345583" class="tableheadintable" dir="auto">Description</p>
</th>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id121512137348477" class="tablecontentsintable" dir="auto">vbGeneralDate</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id511512137351182" class="tablecontentsintable" dir="auto">0</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id991512137353869" class="tablecontentsintable" dir="auto">Displays a date and/or time as defined in your system's General Date setting. If a date only, no time is displayed; If a time only, no date is displayed.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id181512137579110" class="tablecontentsintable" dir="auto">vbLongDate</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id651512137595327" class="tablecontentsintable" dir="auto">1</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id841512137597989" class="tablecontentsintable" dir="auto">Display a date using the long date format specified in your computer's regional settings.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id391512138077008" class="tablecontentsintable" dir="auto">vbShortDate</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id651512137594327" class="tablecontentsintable" dir="auto">2</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id841512137397989" class="tablecontentsintable" dir="auto">Display a date using the short date format specified in your computer's regional settings.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id181512137679110" class="tablecontentsintable" dir="auto">vbLongTime</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id651512137595227" class="tablecontentsintable" dir="auto">3</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id841512147597989" class="tablecontentsintable" dir="auto">Displays a time as defined in your system's Long Time settings.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id183512137579110" class="tablecontentsintable" dir="auto">vbShortTime</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id651512937595327" class="tablecontentsintable" dir="auto">4</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id841517137597989" class="tablecontentsintable" dir="auto">Display a time using the 24-hour format (hh:mm).</p>
</td>
</tr>
</table>
<br>
<div class="embedded">
<a name="errorcode"></a>
<h3 id="hd_id3152869" dir="auto">Error codes:</h3>
</div>
<div class="embedded"><p class="embedded" dir="auto">13 Data type mismatch</p></div>
<div class="embedded">
<a name="functexample"></a>
<h3 id="hd_id061420171139088233" dir="auto">Example:</h3>
</div>
<div class="bascode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Click on text to copy to clipboard"><pre dir="auto"><code class="language-visual-basic line-numbers">
REM ***** BASIC *****
Option VBASupport 1
Sub DateFormat
Dim d as Date
d = ("1958-01-29 00:25")
msgbox("General date format : " & FormatDateTime(d))
msgbox("Long date format : " & FormatDateTime(d,vbLongDate))
msgbox("Short date format : " & FormatDateTime(d,vbShortDate))
msgbox("Long time format : " & FormatDateTime(d,3))
msgbox("Short time format : " & FormatDateTime(d,vbShortTime))
End Sub
</code></pre></div>
<a name="relatedtopics"></a><div class="relatedtopics">
<p class="related" itemprop="mentions" dir="auto"><a name="related"></a><span class="emph">Related Topics</span>
</p>
<div class="relatedbody" itemprop="mentions">
<div class="embedded"><p class="embedded" dir="auto"><a target="_top" href="en-US/text/sbasic/shared/special_vba_func.html#VBADateTime">VBA Time and Date functions</a></p></div>
</div>
</div>
</div>
<div id="DonationFrame"></div>
<footer><div id="DEBUG" class="debug">
<h3 class="bug">Help content debug info:</h3>
<p dir="auto">This page is: <a href="https://opengrok.libreoffice.org/xref/help/source/text/sbasic/shared/03150000.xhp" target="_blank">/text/sbasic/shared/03150000.xhp</a></p>
<p dir="auto">Title is: FormatDateTime Function [VBA]</p>
<p id="bm_module" dir="auto"></p>
<p id="bm_system" dir="auto"></p>
<p id="bm_HID" dir="auto"></p>
</div></footer>
</body>
</html>